<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
	  "http://www.w3.org/TR/html4/loose.dtd">

<html>
  <head>
    <title>The deal.II Readme on interfacing to OpenCASCADE</title>
    <link href="../screen.css" rel="StyleSheet">
    <meta name="copyright" content="Copyright (C) 2010 - 2020 by the deal.II authors">
    <meta name="keywords" content="deal.II">
  </head>
  <body>


    <h2>Installation of <acronym>OpenCASCADE</acronym></h2>

    <p> <a href="http://www.opencascade.org/">OpenCASCADE</a> is a
      software development kit (SDK) intended for development of
      applications dealing with 3D CAD data, freely available in open
      source. It includes a set of C++ class libraries providing
      services for 3D surface and solid modeling, visualization, data
      exchange and rapid application development.</p>

    <p> Below is a short summary of instructions on how to compile and
      install <acronym>OpenCASCADE</acronym> community edition by hand
      (for the case you wish to do so).  </p>

    <h3>How to compile and install <acronym>OpenCASCADE</acronym>
     </h3>

    <p>
Get a clone of the OCE repository:
<pre>
git clone git://github.com/tpaviot/oce.git
</pre>

It is a good practice to build in a separate directory:
<pre>
mkdir build
cd build
cmake -D OCE_INSTALL_PREFIX=/path/to/where/you/want/oce \
      -D OCE_TESTING=OFF \
      -D OCE_VISUALISATION=OFF \
      -D OCE_DISABLE_X11=ON \
      ..
make install
</pre>

This will turn off some packages we don't need. The default package options also work, though.

    <h2>Interfacing <acronym>deal.II</acronym>
      to <acronym>OpenCASCADE</acronym></h2>

    <p>
      Support for <acronym>OpenCASCADE</acronym> will be
      enabled automatically if a system wide installation of
      <acronym>OpenCASCADE</acronym> can be found.
      To use a self compiled version, specify
      <pre>

    -DOPENCASCADE_DIR=/path/to/opencascade/or/oce
      </pre>
      when invoking <code>cmake</code>. Alternatively, you can also set an environment
      variable <code>OPENCASCADE_DIR</code> (valid alternatives are
      also <code>OCC_DIR</code> and <code>OCE_DIR</code>) and cmake
      will pick up this path.
    </p>
    <p>
      You can override the autodetection by manually setting
      <pre>

    -DDEAL_II_WITH_OPENCASCADE=OFF|ON
      </pre>.
    </p>

    <hr />
    <div class="right">
      <a href="http://validator.w3.org/check?uri=referer" target="_top">
        <img style="border:0" src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!"></a>
      <a href="http://jigsaw.w3.org/css-validator/check/referer" target="_top">
        <img style="border:0;width:88px;height:31px" src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
    </div>

  </body>
</html>
